home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
126-150
/
disk_130
/
mach
/
mach.doc
< prev
next >
Wrap
Text File
|
1992-05-06
|
16KB
|
437 lines
Mach - Mouse Accelerator with Hotkeys. Version 1.6a 02-10-88.
MachClk - Mach + Title Bar Clock and Beeper. Version 1.2a 02-10-88.
CONTENTS
NOTES Points to remember.
UPDATES New features/changes.
USAGE How to use and details of features.
EXAMPLES Many usage examples.
REDEFINING How to redefine hotkeys and options.
MISCELLANEOUS Miscellaneous notes and technical information.
SPECIAL FEATURE Disabled users special feature.
QUICK REFERENCE Sample quick reference card.
NOTES: 1. Mach is identical to MachClk minus the clock. Features that
apply only to MachClk are so noted.
2. References in this document to "Qualifier" means either the
left or right Alternate or Amiga keys depending on whether
or not you use "-a" on the command line.
3. When used on the command line, function key numbers are
single digits. 1 is F1, 2 is F2, 9 is F9, and 0 is F10.
UPDATES:
1. Main difference from 1.5/1.1 is the change of -d to -q which
now accumulates qualifiers to be added to the next key.
Unused hotkeys are passed on.
Also, MachClk should not lock up when holding an icon.
2. Main difference in MachClk from 1.2 is the addition of
the option -w which disables the auto clock window to
front and adds a depth gadget.
Orphaned clock windows is now fixed.
USAGE:
Run Mach [nscmqaeb] hotkeystring hotkeystring...hotkeystring
or
Run Mach [nscmqaeb] +1hotkeystring +2hotkeystring...+nhotkeystring
or
Run MachClk [nscmqawebktp] hotkeystring hotkeystring...hotkeystring
or
Run MachClk [nscmqawebktp] +1hotkeystring +2hotkeystring...+nhotkeystring
Options: All are optional. Any order. They may be concatenated but
an option with an argument should be the last one.
e.g. Mach -scb10 (sun mouse, clicktofront and blanker)
-n Acceleration factor where n >= 0 && n <=9.
-s Removes sunmouse.
-c Removes click to front.
-m Removes the trapping of left-amiga-m. (allows normal use)
-q Adds qualifier accumulator feature.
-a Use the Amiga keys as qualifiers.
-w Disables auto clock to front. Adds depth gadget. (MachClk only)
-estr Use str as execute string. Default is "NewCLI >nil: <nil:".
-bnn Time delay before blanking screen. 0-99 minutes. 0 = no blank.
-knnn Put Clock left edge at nnn. (MachClk only)
-tnn Beep every nn minutes. Default 15. (MachClk only)
-pnnnn Set online rate. nnnn = pennies per hour. Default = 475.
Hotkeys:
The hotkeys are the keys F1 to F10 qualified with the left or
right alternate keys. If you prefer to use left or right Amiga, put
-a on the command line. This makes it more compatible with WordPerfect
and other programs that make use of alternate-function keys.
The escape character "\" may be used to introduce newline or a function
key or to add qualifiers.
\n newline
\c control
\a alternate
\A Amiga
\s shift
\f function key where f is 1-0 = F1-F10
c, a, A, s modifiy the next letter. They can be combined.
c, s, and n may be upper case.
Examples:
\C\a\3 is Control-Alternate-F3.
\A\0 sends Amiga-F10.
Hotkeys may call other hotkeys.
The hotkeys are defined in the command line following the optional
options. Definitions with embedded spaces should use "".
They may be positional, that is, the first definition is matched
with F1 and the second with F2. Or, you may specify a function key
with +n. n = 1 - 0 with 0 equaling 10 and no spaces following the
key number. e.g. Run Mach "+5diskcopy df0: to df1:\n"
See more examples in the EXAMPLES section.
You may redefine hotkeys by running Mach again with new definitions.
e.g. Mach +3dir\n "+0run df1:wp\n"
Function keys not assigned to a hotkey string are passed through.
Accelerator:
The accelerator speeds up mouse movements. It accepts as an argument
a number, 0-9, which sets its speed.
-1 is the default, -0 = no acceleration. (I use -4).
NewCLI:
The qualifier and ESCape combination will create a NewCLI á la PopCLI
from The Software Distillary. You need to have NewCLI and Run in the c:
directory. The NewCLI will have the same size stack as Mach. You can
change the command that is executed with -estring. A full window can
be used with "-eNewCLI CON:0/0/640/200/MyCLI".
Screen Blanker:
After 5 minutes of no mouse or keyboard activity, the screen will
go blank. You can change this default with -bnn where nn = 0 - 99
minutes. 0 disables blanking.
Instant blanking: Control-Qualifier-F2.
Sun Mouse:
The window that the pointer is over becomes the active window
after the first mouse movement. To be able to drag icons, the
sun mouse is disabled while the left button is held down.
If you don't want the sun mouse, use -s on the command line.
On/off toggle: Control-Qualifier-F3.
Click To Front:
You can click in any part of a window and bring it to the front.
If you don't want this, use -c on the command line.
On/off toggle: Control-Qualifier-F4.
Screen Shuffler:
Left-Amiga-M will push the front screen to the back instead of
pushing workbench to the back.
Left-Amiga-N will still bring the workbench to the front.
This is useful if you have more than two screens on at once,
especially if they don't have screen depth gadgets.
If you don't want this feature, use -m on your command line.
On/off toggle: Control-Qualifier-F5.
Clock:
MachClk has a title bar clock that displays available memory and the
time. You can change its left edge position with -knnn. For no clock
use -k0 or -k. The clock is updated every second and brings itself
to the front (if covered up) every 4 seconds except when the left
button is held down. Sometimes this covers up information in the
title bar so if you don't like this use the option -w. This disables
the auto upfront and adds a depth gadget.
The current toggles are shown in the left corner of the clock.
They are s: sun mouse, c: click to front, m: Amiga-M screen shuffler,
q: qualifier accumulator, a: Alternate/Amiga qualifiers.
On/off toggle: Control-Qualifier-F8.
Beeper:
MachClk (when the clock is activated) has a beeper (to keep you awake)
which defaults to a 15 minute interval. Change this with -tnn.
nn = 0 to 60 minutes.
Meter:
MachClk has an online cost meter. Use Control-Qualifier-F9 to toggle
between the meter and the clock. Use Control-Qualifier-F10 to reset
the meter. The rate that it uses may be set with "-pnnnn". nnnn is in
pennies per hour. The meter runs continuously whether visible or not.
The default rate is $4.75.
On/off toggle: Control-Qualifier-F9.
Uninstall:
Use the combination Control-Qualifier-F1 to uninstall Mach or MachClk.
Toggles:
These key combinations can be used to toggle specific features.
Ctl-Qualifier-
F3 Sun mouse.
F4 Click to front.
F5 Screen shuffle.
F6 Qualifier Accumulator.
F7 Alternate/Amiga qualifiers.
F8 Clock. (MachClk only)
F9 Meter. (MachClk only)
F10 Reset meter. (MachClk only)
F3-F7 are displayed in the clock as [scmqa].
Instant blanker:
Ctl-Qualifier-F2 Causes the screen to go blank immediately.
EXAMPLES:
Run Mach -2 -m -s df0: df1: "dir\n" "copy " "" "run sys:system/rollodex"
This maps
Alternate-F1 to df0:
Alternate-F2 to df1:
Alternate-F3 to dir + return
Alternate-F4 to copy
Alternate-F5 to nothing
Alternate-F6 to run sys:system/rollodex
The options set the acceleration factor to 2, allows the normal use
of Left-Amiga-M, and disables the sun mouse feature.
Run MachClk -0cab12 "run df1:wp\n" +5df0: \s\c\1 \c\A\0 dir\n\A\1
This maps
Amiga-F1 to run df1:wp + return
Amiga-F5 to df0:
Amiga-F6 to Shift-Control-F1
Amiga-F7 to Control-Amiga-F10
Amiga-F8 to dir + return + Amiga-F1
This example shows how to concatenate options (-0cab12).
The options set the acceleration factor to 0, the function key
qualifiers to the Amiga keys, disables the click to front feature,
and sets the waiting before blanking to 12 minutes.
The clock is placed in its default position and the beeper interval
is the default 15 minutes.
Run MachClk -k200 -t30 -4 -a -w "diskcopy df0: to df1:\n"
This maps
Amiga-F1 to diskcopy df0: to df1: + return
The options use 200 for the clock's left edge, sets the beeper
interval to 30 minutes, the acceleration factor to 4, the
qualifiers to the Amiga keys and disables the auto upfront
and adds a depth gadget.
Run MachClk -p525
This set the online rate to $5.25.
REDEFINING:
Mach may be run again to redefine hotkeys or set the blanking
time delay or the beep interval or to change the toggles.
For example, after Mach is running, typing "Mach -6 +5df0:"
will change the acceleration factor to 6 and redefine F5 to "df0:".
Only the clock position may not be changed this way.
Mach -b10 -p650 +3CCC +2BBB +5EEE FFF
This redefines
Qualifier-F2 to BBB
Qualifier-F3 to CCC
Qualifier-F5 to EEE
Qualifier-F6 to FFF
resets the blanking delay to 10 minutes, and set the online
rate to $6.50.
Mach -eWack
This changes the Qualifier-ESCape command from NewCLI to Wack.
Remember, the executed command will have the same size stack
as Mach.
MISCELLANEOUS:
Note that anything after a semicolon is treated as a comment.
If you are typing this in from the CLI, when you reach the end of
the line, don't hit return and you can continue mapping up to 255
characters (including run mach [options]). If you are using an editor
or word processor, use one that can handle long lines. You can use
Ed but you need to use the command SR or EX. You can then put this
in your startup-sequence.
I have found that the hotkeys do not function properly with the
program Sili(Con:). But they do work ok with ConMan.
There seems to be some slight problems with SunMouse and the
shareware disk utility DiskMan.
Let me know if you find other incompatibilities.
Mach may fail to run for any number of reasons (e.g. no free signals,
insufficient memory). You will be informed of this if it is started
with the Run command. If started from RunBack or RunBackGround
(public domain program that will allow the CLI window to close and
available on Fred Fish disk # 65) Mach won't run and you won't get
any messages. If you want to use RunBack, it is best to test your
script first with Run.
The NewCLI brought up by Qualifier-ESC will have a stack the same
size as Mach. Many programs that you may run from this CLI need a
larger stack so either run Mach with a larger stack or, after you
get a NewCLI, use the stack command to set your stack to a larger
value. If programs mysteriously crash when run from the NewCLI, it
may be caused by the stack size.
SPECIAL FEATURE:
Many disabled people find it difficult if not impossible to
type key combinations such as Control-Shift-F1. If you put
-q on the command line, Mach will remember qualifiers that
are pressed and add them to the first non-qualifier key pressed.
So you could for example, type Control, Alternate, and then F1.
The Control and Alternate would be added to the F1 just as if
they were pressed at the same time. This is not for someone who
doesn't need it as it sometimes may cause unexpected results like
if you type Control and then change your mind, the Control will
still be added to the next key pressed. Pressing Caps Lock will
reset the qualifier accumulator.
Note that because most people will not want this, it defaults to
off unlike all the other features.
On/off toggle: Control-Qualifier-F6.
QUICK REFERENCE:
Modify and print this:
MACH QUICK REFERENCE CARD
TOGGLES:
Cntl-Qualifier-F3 Sun mouse.
Cntl-Qualifier-F4 Click to front.
Cntl-Qualifier-F5 Screen shuffle.
Cntl-Qualifier-F6 Qualifier Accumulator.
Cntl-Qualifier-F7 Alternate/Amiga qualifiers.
Cntl-Qualifier-F8 Clock. (MachClk only)
Cntl-Qualifier-F9 Meter. (MachClk only)
Cntl-Qualifier-F10 Reset meter. (MachClk only)
F3-F7 are displayed in the clock window as [scmqa].
SPECIALS:
Cntl-Qualifier-F1 Remove Mach.
Cntl-Qualifier-F2 Instant screen blanker.
Qualifier-ESC NewCLI
HOTKEYS:
Qualifier-F1 Your hotkey definition.
Qualifier-F2 Your hotkey definition.
Qualifier-F3 Your hotkey definition.
Qualifier-F4 Your hotkey definition.
Qualifier-F5 Your hotkey definition.
Qualifier-F6 Your hotkey definition.
Qualifier-F7 Your hotkey definition.
Qualifier-F8 Your hotkey definition.
Qualifier-F9 Your hotkey definition.
Qualifier-F10 Your hotkey definition.
COMMAND LINE OPTIONS:
-n Acceleration factor where n >= 0 && n <=9.
-s Removes sunmouse.
-c Removes click to front.
-m Removes the trapping of left-amiga-m. (allows normal use)
-q Adds qualifier accumulator feature.
-a Use the Amiga keys as qualifiers.
-w Disables auto clock to front. Adds depth gadget.
-estr Use str as execute string. Default is "NewCLI >nil: <nil:".
-bnn Time delay before blanking screen. 0-99 minutes. 0 = no blank.
-knnn Put Clock left edge at nnn. (MachClk only)
-tnn Beep every nn minutes. Default 15. (MachClk only)
-pnnnn Set online rate. nnnn = pennies per hour. Default = 475.
Copyright 1988 by Brian Moats
Polyglot Software
10431 Ardyce Court
Boise, Idaho 83704
PeopleLink - BrianM
CI$ - 76167,2334
This program may be freely distributed but may not be used in any
commercial product without prior written permission.
Source available. Donations accepted.
Other programs for the Amiga 500/1000/2000 from Polyglot Software:
M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
slice. Public domain.
FunBut - Lets you use the F1 key instead of the left mouse button.
It's useful when playing games like Defender of the Crown
because it sends repeat mouse clicks. Public Domain.
Dominoes - 3d graphics, instructions, tutorial. More entertaining and
challenging than Shanghai. $24.95
The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
pattern matching dictionary, med-res or interlace,
IFF compatible and many more features. $49.95